home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / standard / frontface.z / frontface
Encoding:
Text File  |  1998-10-20  |  3.2 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ffffrrrroooonnnnttttffffaaaacccceeee((((3333GGGG))))                                                    ffffrrrroooonnnnttttffffaaaacccceeee((((3333GGGG))))
  5.  
  6.  
  7.  
  8.  
  9. NNNNAAAAMMMMEEEE
  10.      ffffrrrroooonnnnttttffffaaaacccceeee - turns frontfacing polygon removal on and off
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      vvvvooooiiiidddd ffffrrrroooonnnnttttffffaaaacccceeee((((bbbb))))
  14.      BBBBoooooooolllleeeeaaaannnn bbbb;;;;
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  17.      _b   expects either TRUE or FALSE.
  18.  
  19.          TTTTRRRRUUUUEEEE suppresses the display of frontfacing filled polygons.
  20.  
  21.          FFFFAAAALLLLSSSSEEEE allows the display of frontfacing filled polygons.
  22.  
  23. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.      ffffrrrroooonnnnttttffffaaaacccceeee allows or suppresses the display of frontfacing filled
  25.      polygons.  If your programs represent solid objects as collections of
  26.      polygons, you can use this routine to expose hidden surfaces.    This
  27.      routine works best for simple convex objects that do not obscure other
  28.      objects.
  29.  
  30.      A frontfacing polygon is defined as a polygon whose vertices are in
  31.      counter-clockwise order in screen coordinates.  When frontfacing polygon
  32.      removal is on, the system displays only polygons whose vertices are in
  33.      clockwise order.  For complicated objects, this routine alone may not
  34.      expose all hidden surfaces. To expose hidden surfaces for more
  35.      complicated objects or groups of objects, your routine needs to check the
  36.      relative distances of the object from the viewer (_z values).  (See
  37.      ``Hidden Surface Removal'' in the _G_r_a_p_h_i_c_s _L_i_b_r_a_r_y _P_r_o_g_r_a_m_m_i_n_g _G_u_i_d_e.)
  38.  
  39.      If ffffrrrroooonnnnttttffffaaaacccceeee and bbbbaaaacccckkkkffffaaaacccceeee are asserted simultaneously, no filled polygons
  40.      will be displayed.
  41.  
  42. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  43.      backface, zbuffer
  44.  
  45. NNNNOOOOTTTTEEEE
  46.      On IRIS-4D G and B models ffffrrrroooonnnnttttffffaaaacccceeee does not work well when a polygon
  47.      shrinks to the point where its vertices are coincident.  Under these
  48.      conditions, the routine cannot determine the orientation of the polygon
  49.      and so displays the polygon by default.
  50.  
  51.      On all IRIS-4D models matrices that negate coordinates, such as ssssccccaaaalllleeee ((((----
  52.      1111....0000,,,, 1111....0000,,,, 1111....0000)))),,,, reverse the directional order of a polygon's points and
  53.      can cause ffffrrrroooonnnnttttffffaaaacccceeee to do the opposite of what is intended.
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.